package com.woniuxy.service;

import com.woniuxy.entity.DTO.algorithm.UserChurnDTO;
import com.woniuxy.util.PageResult;
import com.woniuxy.util.ResponseData;

/**
 * @Author 陈华庆
 * @Date 2025/7/23 3:59
 * @Description TODO
 * 用户流失预警服务接口
 * 提供用户活跃度分析及流失风险评估功能
 */
public interface IUserChurnService {
    /**
     * 获取高流失风险用户列表
     * @param pageNum 页码
     * @param pageSize 每页大小
     * @return 分页的高风险用户列表
     */
    ResponseData<PageResult<UserChurnDTO>> getHighRiskUsers(Integer pageNum, Integer pageSize);

    /**
     * 评估单个用户流失风险
     * @param userId 用户ID
     * @return 用户流失风险详情
     */
    ResponseData<UserChurnDTO> evaluateUserChurnRisk(Long userId);
}
